Changelog Entry

Added

• Added MathML/TeX block support in Markdown via micromark-extension-math and katex, in PR #5332, by @compulim

Description

After we migrated to micromark in PR #5330, this PR will add micromark-extension-math to enable $$ block for maths.

It will use KaTeX to convert TeX inside the block into MathML <math>.

Design

We explicitly disabled $ (inline math block) to prevent collision.

Using MathML as output will not require CSS/WOFF2 which could add up bundle size, with tradeoff of visualization quality. We will tackle this issue later.

The micromark-extension-math package is contributing roughly 260 KiB (9%) to our bundle size.

Accessibility is done by the browser for MathML.

Specific Changes

• Added micromark-extension-math package

• I have added tests and executed them locally
• I have updated CHANGELOG.md
• I have updated documentation

Review Checklist

This section is for contributors to review your work.

• Accessibility reviewed (tab order, content readability, alt text, color contrast)
• Browser and platform compatibilities reviewed
• CSS styles reviewed (minimal rules, no z-index)
• Documents reviewed (docs, samples, live demo)
• Internationalization reviewed (strings, unit formatting)
• package.json and package-lock.json reviewed
• Security reviewed (no data URIs, check for nonce leak)
• Tests reviewed (coverage, legitimacy)